COMPPSX

COMPPSX by Gavin Thornton (13/9/96). Manual by Gavin Thornton.
Copyright Datel Design & Development 1996.

Cheat data text to binary cheat data file compiler for PSX Comms kit. Support software for the Action Replay/Game Shark PSX comms kits. Copyright Datel Design & Development 1996.


COMPPSX	
INTRODUCTION	
WHAT COMPPSX CAN SO AND WHY DO I NEED IT?	
ADDING AN ENTRY TO THE GAME LIST.	
ENTERING A GAME AND ITS CODES	
COMMENTS	
CODES WHICH DEFAULT TO ON OR OFF	
MASTER CODES	
STOPPING AT A POINT IN THE FILE	
UPDATING THE CARTRIDGE WITH THE NEW CODES	


Introduction
Cheat data text to binary cheat data file compiler for PSX Comms kit. Support software for the Action Replay/Game Shark PSX comms kits. Copyright Datel Design & Development 1996.

Please report bugs to gavin@datel.co.uk (email)

Usage :   COMPSX [<options>] <Code Text File> <Destination BIN file>
Example:  COMPSX mycodes.txt ukcodes.bin

		  If no arguments are given then the default files GAMEDAT.TXT
		  and UKCODES.BIN are used.

		  <options>
		  ?       - List this help text
		  L       - List compiler commands
		  E<num>  - Set error count (stop after NUM errors or 0=infinite)


Well? What do you want to know (good manual so far eh?).

First of all have a quick look at the supplied files "UKCODES.TXT", "USACODES.TXT" and "JAPCODES.TXT". These three files contain all the latest codes we have at Datel (coo blimey!). The format of these files is what the COMPPSX compiler requires - most of it is self explanatory.

You can obtain the very latest codes and software updates from our snazzy web page "www.datel.co.uk".


What COMPPSX Can So And Why Do I Need It?
This neat little utility simply lets you update your Action Replay/Game Shark/Game Buster game codes from a text file on your PC. If you regularly find yourself entering new codes (which you  found yourself or got elsewhere) then you will find this program very useful indeed. 

This program converts text files which contain game codes into files which can be downloaded to the cartridge when you use the upgrade program. Hence, you can have only the codes YOU want on the cartridge and can easily update the codes simply by editing a text file. 


Adding an entry to the game list.
You can add codes to any of the supplied code lists ("UKCODES.TXT", "USACODES.TXT", "JAPCODES.TXT") or create a file of your own. The files are ASCII text files so you can use any standard text editor or word processing package (as long as you save out the file as standard text).

Entering a Game and its Codes
I will explain the format of a game entry by way of example :-

The first part of and entry must be the games name in quotation marks.
		"my game"

Following the name you have it's codes; Codes are made up of the code name (again in quotes).....
		"code name 1"

....followed by any number of code parameters (code parameters are made up of an 8 digit hexadecimal number, then a space ' ' character, then a 4 digit hexadecimal number).
		8001a630 0163

You must now end the game entry with the text ".end".
		.end

The finished game entry with it's single code should now look like this :-

		"my game"

		"code name 1"
		8001a630 0163

		.end

If you have more than one code parameter to follow a code's name simply put it after the first code parameter. e.g. :-

		"my game"

		"code name 1"
		8001a630 0163
		8001a632 0163

		.end

If you have more than one code for the game then simply put it after the first code. e.g. :-

		"my game"

		"code name 1"
		8001a630 0163
		8001a632 0163

		"code name 2"
		8001a928 0009

		.end

Comments
You can also put comments in the file. Comments are lines which the COMPPSX program ignores. These are useful for adding 'line breaks' between game's or simply putting comments in with your game lists. In the example game list files comments are used to separate game entries and note the date of the game code (when the game was entered).

A comment line must start with a '#' or ';' character.

Example :-

		#--------------------------------------
		# I added this on 27/8/96
		
		"my 1st game"

		"code name 1"
		8001a630 0163
		8001a632 0163

		"code name 2"
		8001a928 0009

		.end
		#--------------------------------------


Codes Which Default to ON or OFF
As in the cartridge "edit code" function you can make codes default to being ON or OFF in the list when you first look at them. By default the codes in the list are ON. You can make individual codes default to off by putting the text ".off" after the codes name. e.g. The code named "code name 2" will default to OFF :-

		"my 1st game"

		"code name 1"
		8001a630 0163
		8001a632 0163

		"code name 2" .off
		8001a928 0009

		.end


Master Codes
You can enter master codes simply by giving the code the name "master code". 

		"my 1st game"

		"master code"
		D0012345 1012

		"code name 1"
		8001a630 0163

		.end

Stopping at a Point in the File
You can end the code file generation process at any point in your list as long as it is after the end of a game entry (not in the middle of an entry). To do this simply insert the text ".stop". e.g. The below file would result in the game "my 1st game" being in the list but not the game "my 2nd game" as there is a ".stop" command before this game:-

		#--------------------------------------
		# I added this on 27/8/96
		
		"my 1st game"

		"code name 1"
		8001a630 0163

		.end

		.stop
		#--------------------------------------
		# I added this on 27/8/96
		
		"my 2nd game"

		"code name 1"
		8004a500 0172

		.end
		#--------------------------------------



Updating the Cartridge with the New Codes
You must have ACTION.EXE version 1.4 or above in order to update the codes.

Create your game codes file with the COMPPSX.EXE program with the destination file named as UKCODES.BIN. e.g. Type the following at the Dos prompt :-

		COMPPSX  UKCODES.TXT  UKCODES.BIN

This will create the file UKCODES.BIN from the game code list UKCODES.TXT. Substitute the file name UKCODES.TXT for the game list file you wish to use.

Copy the file UKCODES.BIN into your PSX directory over the existing file (you may want to make a backup of the original file first).

Go into the PSX directory and run the UPGRADE program (type "upgrade" and press return).

At the upgrade programs menu select the "settings" option (option 2) and in the sub-menu ensure that option 2 is set to "Preset with UK codes".

Exit back to the previous menu and select option 1 "upgrade". Follow the on screen prompts and your cartridge will be updated with the new set of codes.










1



